home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 July: Mac OS SDK / Dev.CD Jul 99 SDK1.toast / Development Kits / Mac OS / Interfaces&Libraries / Universal / Interfaces / AIncludes / QD3D.a < prev    next >
Encoding:
Text File  |  1998-08-17  |  37.4 KB  |  1,203 lines  |  [TEXT/MPS ]
  1. ;
  2. ;    File:        QD3D.a
  3. ;
  4. ;    Contains:    Base types for Quickdraw 3D                            
  5. ;
  6. ;    Version:    Technology:    Quickdraw 3D 1.5.4
  7. ;                Release:    Universal Interfaces 3.2
  8. ;
  9. ;    Copyright:    © 1995-1998 by Apple Computer, Inc., all rights reserved.
  10. ;
  11. ;    Bugs?:        For bug reports, consult the following page on
  12. ;                the World Wide Web:
  13. ;
  14. ;                    http://developer.apple.com/bugreporter/
  15. ;
  16. ;
  17.     IF &TYPE('__QD3D__') = 'UNDEFINED' THEN
  18. __QD3D__ SET 1
  19.  
  20.     IF &TYPE('__CONDITIONALMACROS__') = 'UNDEFINED' THEN
  21.     include 'ConditionalMacros.a'
  22.     ENDIF
  23.  
  24.     IF TARGET_OS_MAC THEN
  25.     IF &TYPE('__MACTYPES__') = 'UNDEFINED' THEN
  26.     include 'MacTypes.a'
  27.     ENDIF
  28.     ENDIF    ; TARGET_OS_MAC
  29.     IF TARGET_OS_MAC THEN
  30.     OS_MACINTOSH: SET 1
  31.     OS_WIN32: SET 0
  32.     OS_UNIX: SET 0
  33.     OS_NEXT: SET 0
  34.     WINDOW_SYSTEM_MACINTOSH: SET 1
  35.     WINDOW_SYSTEM_WIN32: SET 0
  36.     WINDOW_SYSTEM_X11: SET 0
  37.     WINDOW_SYSTEM_NEXT: SET 0
  38.     ENDIF    ; TARGET_OS_MAC
  39.  
  40. ; ******************************************************************************
  41. ; **                                                                             **
  42. ; **                                NULL definition                                 **
  43. ; **                                                                             **
  44. ; ****************************************************************************
  45.  
  46. ; ******************************************************************************
  47. ; **                                                                             **
  48. ; **                                    Objects                                     **
  49. ; **                                                                             **
  50. ; ****************************************************************************
  51.  
  52. ; 
  53. ; * Everything in QuickDraw 3D is an OBJECT: a bunch of data with a type,
  54. ; * deletion, duplication, and i/o methods.
  55. ; 
  56.  
  57. ; typedef long                             TQ3ObjectType
  58.  
  59.  
  60.  
  61. ;  
  62. ; 
  63. ; * There are four subclasses of OBJECT:
  64. ; *    an ELEMENT, which is data that is placed in a SET
  65. ; *    a SHAREDOBJECT, which is reference-counted data that is shared
  66. ; *    VIEWs, which maintain state information for an image
  67. ; *    a PICK, which used to query a VIEW
  68. ; 
  69.  
  70. ; typedef TQ3Object                     TQ3ElementObject
  71.  
  72. ; typedef TQ3Object                     TQ3SharedObject
  73.  
  74. ; typedef TQ3Object                     TQ3ViewObject
  75.  
  76. ; typedef TQ3Object                     TQ3PickObject
  77.  
  78. ; 
  79. ; * There are several types of SharedObjects:
  80. ; *    RENDERERs, which paint to a drawContext
  81. ; *    DRAWCONTEXTs, which are an interface to a device 
  82. ; *    SETs, which maintains "mathematical sets" of ELEMENTs
  83. ; *    FILEs, which maintain state information for a metafile
  84. ; *    SHAPEs, which affect the state of the View
  85. ; *    SHAPEPARTs, which contain geometry-specific data about a picking hit
  86. ; *    CONTROLLERSTATEs, which hold state of the output channels for a CONTROLLER
  87. ; *    TRACKERs, which represent a position and orientation in the user interface
  88. ; *  STRINGs, which are abstractions of text string data.
  89. ; *    STORAGE, which is an abstraction for stream-based data storage (files, memory)
  90. ; *    TEXTUREs, for sharing bitmap information for TEXTURESHADERS
  91. ; *    VIEWHINTs, which specifies viewing preferences in FILEs
  92. ; 
  93.  
  94. ; typedef TQ3SharedObject                 TQ3RendererObject
  95.  
  96. ; typedef TQ3SharedObject                 TQ3DrawContextObject
  97.  
  98. ; typedef TQ3SharedObject                 TQ3SetObject
  99.  
  100. ; typedef TQ3SharedObject                 TQ3FileObject
  101.  
  102. ; typedef TQ3SharedObject                 TQ3ShapeObject
  103.  
  104. ; typedef TQ3SharedObject                 TQ3ShapePartObject
  105.  
  106. ; typedef TQ3SharedObject                 TQ3ControllerStateObject
  107.  
  108. ; typedef TQ3SharedObject                 TQ3TrackerObject
  109.  
  110. ; typedef TQ3SharedObject                 TQ3StringObject
  111.  
  112. ; typedef TQ3SharedObject                 TQ3StorageObject
  113.  
  114. ; typedef TQ3SharedObject                 TQ3TextureObject
  115.  
  116. ; typedef TQ3SharedObject                 TQ3ViewHintsObject
  117.  
  118. ; 
  119. ; * There is one types of SET:
  120. ; *    ATTRIBUTESETs, which contain ATTRIBUTEs which are inherited 
  121. ; 
  122.  
  123. ; typedef TQ3SetObject                     TQ3AttributeSet
  124.  
  125. ; 
  126. ; * There are many types of SHAPEs:
  127. ; *    LIGHTs, which affect how the RENDERER draws 3-D cues
  128. ; *    CAMERAs, which affects the location and orientation of the RENDERER in space
  129. ; *    GROUPs, which may contain any number of SHARED OBJECTS
  130. ; *    GEOMETRYs, which are representations of three-dimensional data
  131. ; *    SHADERs, which affect how colors are drawn on a geometry
  132. ; *    STYLEs, which affect how the RENDERER paints to the DRAWCONTEXT
  133. ; *    TRANSFORMs, which affect the coordinate system in the VIEW
  134. ; *    REFERENCEs, which are references to objects in FILEs
  135. ; *  UNKNOWN, which hold unknown objects read from a metafile.
  136. ; 
  137.  
  138. ; typedef TQ3ShapeObject                 TQ3GroupObject
  139.  
  140. ; typedef TQ3ShapeObject                 TQ3GeometryObject
  141.  
  142. ; typedef TQ3ShapeObject                 TQ3ShaderObject
  143.  
  144. ; typedef TQ3ShapeObject                 TQ3StyleObject
  145.  
  146. ; typedef TQ3ShapeObject                 TQ3TransformObject
  147.  
  148. ; typedef TQ3ShapeObject                 TQ3LightObject
  149.  
  150. ; typedef TQ3ShapeObject                 TQ3CameraObject
  151.  
  152. ; typedef TQ3ShapeObject                 TQ3UnknownObject
  153.  
  154. ; typedef TQ3ShapeObject                 TQ3ReferenceObject
  155.  
  156. ; 
  157. ; * For now, there is only one type of SHAPEPARTs:
  158. ; *    MESHPARTs, which describe some part of a mesh
  159. ; 
  160.  
  161. ; typedef TQ3ShapePartObject             TQ3MeshPartObject
  162.  
  163. ; 
  164. ; * There are three types of MESHPARTs:
  165. ; *    MESHFACEPARTs, which describe a face of a mesh
  166. ; *    MESHEDGEPARTs, which describe a edge of a mesh
  167. ; *    MESHVERTEXPARTs, which describe a vertex of a mesh
  168. ; 
  169.  
  170. ; typedef TQ3MeshPartObject             TQ3MeshFacePartObject
  171.  
  172. ; typedef TQ3MeshPartObject             TQ3MeshEdgePartObject
  173.  
  174. ; typedef TQ3MeshPartObject             TQ3MeshVertexPartObject
  175.  
  176. ; 
  177. ; * A DISPLAY Group can be drawn to a view
  178. ; 
  179.  
  180. ; typedef TQ3GroupObject                 TQ3DisplayGroupObject
  181.  
  182. ; 
  183. ; * There are many types of SHADERs:
  184. ; *    SURFACESHADERs, which affect how the surface of a geometry is painted
  185. ; *    ILLUMINATIONSHADERs, which affect how lights affect the color of a surface
  186. ; 
  187.  
  188. ; typedef TQ3ShaderObject                 TQ3SurfaceShaderObject
  189.  
  190. ; typedef TQ3ShaderObject                 TQ3IlluminationShaderObject
  191.  
  192. ; 
  193. ; * A handle to an object in a group
  194. ; 
  195.  
  196.  
  197.  
  198. ;  
  199. ; * TQ3ObjectClassNameString is used for the class name of an object
  200. ; 
  201.  
  202.  
  203. kQ3StringMaximumLength            EQU        1024
  204. TQ3ObjectClassNameString RECORD 0
  205. elements                 ds.b    1024
  206. sizeof                     EQU *                    ; size:   $400 (1024)
  207.                         ENDR
  208.  
  209.  
  210. ; ******************************************************************************
  211. ; **                                                                             **
  212. ; **                            Client/Server Things                             **
  213. ; **                                                                             **
  214. ; ****************************************************************************
  215.  
  216. ; typedef void *                        TQ3ControllerRef
  217.  
  218. ; ******************************************************************************
  219. ; **                                                                             **
  220. ; **                            Flags and Switches                                 **
  221. ; **                                                                             **
  222. ; ****************************************************************************
  223.  
  224.  
  225. ; typedef long                            TQ3Boolean
  226. kQ3False                        EQU        0
  227. kQ3True                            EQU        1
  228.  
  229. ; typedef long                            TQ3Switch
  230. kQ3Off                            EQU        0
  231. kQ3On                            EQU        1
  232.  
  233. ; typedef long                            TQ3Status
  234. kQ3Failure                        EQU        0
  235. kQ3Success                        EQU        1
  236.  
  237. ; typedef long                            TQ3Axis
  238. kQ3AxisX                        EQU        0
  239. kQ3AxisY                        EQU        1
  240. kQ3AxisZ                        EQU        2
  241.  
  242. ; typedef long                            TQ3PixelType
  243. kQ3PixelTypeRGB32                EQU        0                    ; Alpha:8 (ignored), R:8, G:8, B:8    
  244. kQ3PixelTypeARGB32                EQU        1                    ; Alpha:8, R:8, G:8, B:8             
  245. kQ3PixelTypeRGB16                EQU        2                    ; Alpha:1 (ignored), R:5, G:5, B:5    
  246. kQ3PixelTypeARGB16                EQU        3                    ; Alpha:1, R:5, G:5, B:5             
  247. kQ3PixelTypeRGB16_565            EQU        4                    ; Win32 only: 16 bits/pixel, R:5, G:6, B:5        
  248. kQ3PixelTypeRGB24                EQU        5                    ; Win32 only: 24 bits/pixel, R:8, G:8, B:8        
  249.  
  250. ; typedef long                            TQ3Endian
  251. kQ3EndianBig                    EQU        0
  252. kQ3EndianLittle                    EQU        1
  253.  
  254. ; typedef long                            TQ3EndCapMasks
  255. kQ3EndCapNone                    EQU        0
  256. kQ3EndCapMaskTop                EQU        $01
  257. kQ3EndCapMaskBottom                EQU        $02
  258. kQ3EndCapMaskInterior            EQU        $04
  259. ; typedef unsigned long                 TQ3EndCap
  260.  
  261.  
  262. kQ3ArrayIndexNULL                EQU        -1
  263. ; ******************************************************************************
  264. ; **                                                                             **
  265. ; **                        Point and Vector Definitions                         **
  266. ; **                                                                             **
  267. ; ****************************************************************************
  268.  
  269. TQ3Vector2D                RECORD 0
  270. x                         ds        Float32            ; offset: $0 (0)
  271. y                         ds        Float32            ; offset: $4 (4)
  272. sizeof                     EQU *                    ; size:   $8 (8)
  273.                         ENDR
  274. TQ3Vector3D                RECORD 0
  275. x                         ds        Float32            ; offset: $0 (0)
  276. y                         ds        Float32            ; offset: $4 (4)
  277. z                         ds        Float32            ; offset: $8 (8)
  278. sizeof                     EQU *                    ; size:   $C (12)
  279.                         ENDR
  280. TQ3Point2D                RECORD 0
  281. x                         ds        Float32            ; offset: $0 (0)
  282. y                         ds        Float32            ; offset: $4 (4)
  283. sizeof                     EQU *                    ; size:   $8 (8)
  284.                         ENDR
  285. TQ3Point3D                RECORD 0
  286. x                         ds        Float32            ; offset: $0 (0)
  287. y                         ds        Float32            ; offset: $4 (4)
  288. z                         ds        Float32            ; offset: $8 (8)
  289. sizeof                     EQU *                    ; size:   $C (12)
  290.                         ENDR
  291. TQ3RationalPoint4D        RECORD 0
  292. x                         ds        Float32            ; offset: $0 (0)
  293. y                         ds        Float32            ; offset: $4 (4)
  294. z                         ds        Float32            ; offset: $8 (8)
  295. w                         ds        Float32            ; offset: $C (12)
  296. sizeof                     EQU *                    ; size:   $10 (16)
  297.                         ENDR
  298. TQ3RationalPoint3D        RECORD 0
  299. x                         ds        Float32            ; offset: $0 (0)
  300. y                         ds        Float32            ; offset: $4 (4)
  301. w                         ds        Float32            ; offset: $8 (8)
  302. sizeof                     EQU *                    ; size:   $C (12)
  303.                         ENDR
  304. ; ******************************************************************************
  305. ; **                                                                             **
  306. ; **                                Quaternion                                     **
  307. ; **                                                                             **
  308. ; ****************************************************************************
  309.  
  310. TQ3Quaternion            RECORD 0
  311. w                         ds        Float32            ; offset: $0 (0)
  312. x                         ds        Float32            ; offset: $4 (4)
  313. y                         ds        Float32            ; offset: $8 (8)
  314. z                         ds        Float32            ; offset: $C (12)
  315. sizeof                     EQU *                    ; size:   $10 (16)
  316.                         ENDR
  317. ; ******************************************************************************
  318. ; **                                                                             **
  319. ; **                                Ray Definition                                 **
  320. ; **                                                                             **
  321. ; ****************************************************************************
  322.  
  323. TQ3Ray3D                RECORD 0
  324. origin                     ds        TQ3Point3D        ; offset: $0 (0)
  325. direction                 ds        TQ3Vector3D        ; offset: $C (12)
  326. sizeof                     EQU *                    ; size:   $18 (24)
  327.                         ENDR
  328. ; ******************************************************************************
  329. ; **                                                                             **
  330. ; **                        Parameterization Data Structures                     **
  331. ; **                                                                             **
  332. ; ****************************************************************************
  333.  
  334. TQ3Param2D                RECORD 0
  335. u                         ds        Float32            ; offset: $0 (0)
  336. v                         ds        Float32            ; offset: $4 (4)
  337. sizeof                     EQU *                    ; size:   $8 (8)
  338.                         ENDR
  339. TQ3Param3D                RECORD 0
  340. u                         ds        Float32            ; offset: $0 (0)
  341. v                         ds        Float32            ; offset: $4 (4)
  342. w                         ds        Float32            ; offset: $8 (8)
  343. sizeof                     EQU *                    ; size:   $C (12)
  344.                         ENDR
  345. TQ3Tangent2D            RECORD 0
  346. uTangent                 ds        TQ3Vector3D        ; offset: $0 (0)
  347. vTangent                 ds        TQ3Vector3D        ; offset: $C (12)
  348. sizeof                     EQU *                    ; size:   $18 (24)
  349.                         ENDR
  350. TQ3Tangent3D            RECORD 0
  351. uTangent                 ds        TQ3Vector3D        ; offset: $0 (0)
  352. vTangent                 ds        TQ3Vector3D        ; offset: $C (12)
  353. wTangent                 ds        TQ3Vector3D        ; offset: $18 (24)
  354. sizeof                     EQU *                    ; size:   $24 (36)
  355.                         ENDR
  356. ; ******************************************************************************
  357. ; **                                                                             **
  358. ; **                        Polar and Spherical Coordinates                         **
  359. ; **                                                                             **
  360. ; ****************************************************************************
  361.  
  362. TQ3PolarPoint            RECORD 0
  363. r                         ds        Float32            ; offset: $0 (0)
  364. theta                     ds        Float32            ; offset: $4 (4)
  365. sizeof                     EQU *                    ; size:   $8 (8)
  366.                         ENDR
  367. TQ3SphericalPoint        RECORD 0
  368. rho                         ds        Float32            ; offset: $0 (0)
  369. theta                     ds        Float32            ; offset: $4 (4)
  370. phi                         ds        Float32            ; offset: $8 (8)
  371. sizeof                     EQU *                    ; size:   $C (12)
  372.                         ENDR
  373. ; ******************************************************************************
  374. ; **                                                                             **
  375. ; **                            Color Definition                                 **
  376. ; **                                                                             **
  377. ; ****************************************************************************
  378.  
  379. TQ3ColorRGB                RECORD 0
  380. r                         ds        Float32            ; offset: $0 (0)
  381. g                         ds        Float32            ; offset: $4 (4)
  382. b                         ds        Float32            ; offset: $8 (8)
  383. sizeof                     EQU *                    ; size:   $C (12)
  384.                         ENDR
  385. TQ3ColorARGB            RECORD 0
  386. a                         ds        Float32            ; offset: $0 (0)
  387. r                         ds        Float32            ; offset: $4 (4)
  388. g                         ds        Float32            ; offset: $8 (8)
  389. b                         ds        Float32            ; offset: $C (12)
  390. sizeof                     EQU *                    ; size:   $10 (16)
  391.                         ENDR
  392. ; ******************************************************************************
  393. ; **                                                                             **
  394. ; **                                    Vertices                                 **
  395. ; **                                                                             **
  396. ; ****************************************************************************
  397.  
  398. TQ3Vertex3D                RECORD 0
  399. point                     ds        TQ3Point3D        ; offset: $0 (0)
  400. attributeSet             ds.l    1                ; offset: $C (12)
  401. sizeof                     EQU *                    ; size:   $10 (16)
  402.                         ENDR
  403. ; ******************************************************************************
  404. ; **                                                                             **
  405. ; **                                    Matrices                                 **
  406. ; **                                                                             **
  407. ; ****************************************************************************
  408.  
  409. TQ3Matrix3x3            RECORD 0
  410. value                     ds.b    3 * 3 * Float32.sizeof ; offset: $0 (0)
  411. sizeof                     EQU *                    ; size:   $24 (36)
  412.                         ENDR
  413. TQ3Matrix4x4            RECORD 0
  414. value                     ds.b    4 * 4 * Float32.sizeof ; offset: $0 (0)
  415. sizeof                     EQU *                    ; size:   $40 (64)
  416.                         ENDR
  417. ; ******************************************************************************
  418. ; **                                                                             **
  419. ; **                                Bitmap/Pixmap                                 **
  420. ; **                                                                             **
  421. ; ****************************************************************************
  422.  
  423. TQ3Pixmap                RECORD 0
  424. image                     ds.l    1                ; offset: $0 (0)
  425. width                     ds.l    1                ; offset: $4 (4)
  426. height                     ds.l    1                ; offset: $8 (8)
  427. rowBytes                 ds.l    1                ; offset: $C (12)
  428. pixelSize                 ds.l    1                ; offset: $10 (16)        ;  MUST be 16 or 32 to use with the    Interactive Renderer on Mac OS
  429. pixelType                 ds.l    1                ; offset: $14 (20)
  430. bitOrder                 ds.l    1                ; offset: $18 (24)
  431. byteOrder                 ds.l    1                ; offset: $1C (28)
  432. sizeof                     EQU *                    ; size:   $20 (32)
  433.                         ENDR
  434. TQ3StoragePixmap        RECORD 0
  435. image                     ds.l    1                ; offset: $0 (0)
  436. width                     ds.l    1                ; offset: $4 (4)
  437. height                     ds.l    1                ; offset: $8 (8)
  438. rowBytes                 ds.l    1                ; offset: $C (12)
  439. pixelSize                 ds.l    1                ; offset: $10 (16)        ;  MUST be 16 or 32 to use with the    Interactive Renderer on Mac OS
  440. pixelType                 ds.l    1                ; offset: $14 (20)
  441. bitOrder                 ds.l    1                ; offset: $18 (24)
  442. byteOrder                 ds.l    1                ; offset: $1C (28)
  443. sizeof                     EQU *                    ; size:   $20 (32)
  444.                         ENDR
  445. TQ3Bitmap                RECORD 0
  446. image                     ds.l    1                ; offset: $0 (0)
  447. width                     ds.l    1                ; offset: $4 (4)
  448. height                     ds.l    1                ; offset: $8 (8)
  449. rowBytes                 ds.l    1                ; offset: $C (12)
  450. bitOrder                 ds.l    1                ; offset: $10 (16)
  451. sizeof                     EQU *                    ; size:   $14 (20)
  452.                         ENDR
  453. TQ3MipmapImage            RECORD 0
  454. ;  An image for use as a texture mipmap  
  455. width                     ds.l    1                ; offset: $0 (0)        ;  Width of mipmap, must be power of 2   
  456. height                     ds.l    1                ; offset: $4 (4)        ;  Height of mipmap, must be power of 2  
  457. rowBytes                 ds.l    1                ; offset: $8 (8)        ;  Rowbytes of mipmap                    
  458. offset                     ds.l    1                ; offset: $C (12)        ;  Offset from image base to this mipmap 
  459. sizeof                     EQU *                    ; size:   $10 (16)
  460.                         ENDR
  461. TQ3Mipmap                RECORD 0
  462. image                     ds.l    1                ; offset: $0 (0)        ;  Data containing the texture map and      
  463. ;  if (useMipmapping==kQ3True) the          
  464. ;  mipmap data                              
  465. useMipmapping             ds.l    1                ; offset: $4 (4)        ;  True if mipmapping should be used      
  466. ;  and all mipmaps have been provided    
  467. pixelType                 ds.l    1                ; offset: $8 (8)
  468. bitOrder                 ds.l    1                ; offset: $C (12)
  469. byteOrder                 ds.l    1                ; offset: $10 (16)
  470. reserved                 ds.l    1                ; offset: $14 (20)        ;  leave NULL for next version             
  471. mipmaps                     ds.b    32 * TQ3MipmapImage.sizeof ; offset: $18 (24) ;  The actual number of mipmaps is determined from the size of the first mipmap 
  472. sizeof                     EQU *                    ; size:   $218 (536)
  473.                         ENDR
  474.  
  475. ; ******************************************************************************
  476. ; **                                                                             **
  477. ; **                        Higher dimension quantities                             **
  478. ; **                                                                             **
  479. ; ****************************************************************************
  480.  
  481. TQ3Area                    RECORD 0
  482. min                         ds        TQ3Point2D        ; offset: $0 (0)
  483. max                         ds        TQ3Point2D        ; offset: $8 (8)
  484. sizeof                     EQU *                    ; size:   $10 (16)
  485.                         ENDR
  486. TQ3PlaneEquation        RECORD 0
  487. normal                     ds        TQ3Vector3D        ; offset: $0 (0)
  488. constant                 ds        Float32            ; offset: $C (12)
  489. sizeof                     EQU *                    ; size:   $10 (16)
  490.                         ENDR
  491. TQ3BoundingBox            RECORD 0
  492. min                         ds        TQ3Point3D        ; offset: $0 (0)
  493. max                         ds        TQ3Point3D        ; offset: $C (12)
  494. isEmpty                     ds.l    1                ; offset: $18 (24)
  495. sizeof                     EQU *                    ; size:   $1C (28)
  496.                         ENDR
  497. TQ3BoundingSphere        RECORD 0
  498. origin                     ds        TQ3Point3D        ; offset: $0 (0)
  499. radius                     ds        Float32            ; offset: $C (12)
  500. isEmpty                     ds.l    1                ; offset: $10 (16)
  501. sizeof                     EQU *                    ; size:   $14 (20)
  502.                         ENDR
  503. ; 
  504. ; *    The TQ3ComputeBounds flag passed to StartBoundingBox or StartBoundingSphere
  505. ; *    calls in the View. It's a hint to the system as to how it should 
  506. ; *    compute the bbox of a shape:
  507. ; *
  508. ; *    kQ3ComputeBoundsExact:    
  509. ; *        Vertices of shapes are transformed into world space and
  510. ; *        the world space bounding box is computed from them.  Slow!
  511. ; *    
  512. ; *    kQ3ComputeBoundsApproximate: 
  513. ; *        A local space bounding box is computed from a shape's
  514. ; *        vertices.  This bbox is then transformed into world space,
  515. ; *        and its bounding box is taken as the shape's approximate
  516. ; *        bbox.  Fast but the bbox is larger than optimal.
  517. ; 
  518.  
  519.  
  520. ; typedef long                            TQ3ComputeBounds
  521. kQ3ComputeBoundsExact            EQU        0
  522. kQ3ComputeBoundsApproximate        EQU        1
  523.  
  524. ; ******************************************************************************
  525. ; **                                                                             **
  526. ; **                            Object System Types                                 **
  527. ; **                                                                             **
  528. ; ****************************************************************************
  529.  
  530.  
  531.  
  532.  
  533. ; typedef unsigned long                 TQ3XMethodType
  534.  
  535. ; 
  536. ; * Object methods
  537. ; 
  538.  
  539. ;  
  540. ; *  Return true from the metahandler if this 
  541. ; *  object can be submitted in a rendering loop 
  542. ; 
  543.  
  544. ; 
  545. ; * MetaHandler:
  546. ; *        When you give a metahandler to QuickDraw 3D, it is called multiple 
  547. ; *        times to build method tables, and then is thrown away. You are 
  548. ; *        guaranteed that your metahandler will never be called again after a 
  549. ; *        call that was passed a metahandler returns.
  550. ; *
  551. ; *        Your metahandler should contain a switch on the methodType passed to it
  552. ; *        and should return the corresponding method as an TQ3XFunctionPointer.
  553. ; *
  554. ; *        IMPORTANT: A metaHandler MUST always "return" a value. If you are
  555. ; *        passed a methodType that you do not understand, ALWAYS return NULL.
  556. ; *
  557. ; *        These types here are prototypes of how your functions should look.
  558. ; 
  559.  
  560. ; 
  561. ; * See QD3DIO.h for the IO method types: 
  562. ; *        ObjectReadData, ObjectTraverse, ObjectWrite
  563. ; 
  564.  
  565.  
  566. ; ******************************************************************************
  567. ; **                                                                             **
  568. ; **                                Set Types                                     **
  569. ; **                                                                             **
  570. ; ****************************************************************************
  571.  
  572. ; typedef long                             TQ3ElementType
  573.  
  574.  
  575. kQ3ElementTypeNone                EQU        0
  576. kQ3ElementTypeUnknown            EQU        32
  577. kQ3ElementTypeSet                EQU        33
  578.  
  579. ;  
  580. ; *    kQ3ElementTypeUnknown is a TQ3Object. 
  581. ; *    
  582. ; *        Do Q3Set_Add(s, ..., &obj) or Q3Set_Get(s, ..., &obj);
  583. ; *        
  584. ; *        Note that the object is always referenced when copying around. 
  585. ; *        
  586. ; *        Generally, it is an Unknown object, a Group of Unknown objects, or a 
  587. ; *        group of other "objects" which have been found in the metafile and
  588. ; *        have no attachment method to their parent. Be prepared to handle
  589. ; *        any or all of these cases if you actually access the set on a shape.
  590. ; *
  591. ; *    kQ3ElementTypeSet is a TQ3SetObject. 
  592. ; *    
  593. ; *        Q3Shape_GetSet(s,&o) is eqivalent to 
  594. ; *            Q3Shape_GetElement(s, kQ3ElementTypeSet, &o)
  595. ; *            
  596. ; *        Q3Shape_SetSet(s,o)  is eqivalent to 
  597. ; *            Q3Shape_SetElement(s, kQ3ElementTypeSet, &o)
  598. ; *    
  599. ; *        Note that the object is always referenced when copying around. 
  600. ; *        
  601. ; *    See the note below about the Set and Shape changes.
  602. ; 
  603.  
  604.  
  605. ; ******************************************************************************
  606. ; **                                                                             **
  607. ; **                            Object System Macros                             **
  608. ; **                                                                             **
  609. ; ****************************************************************************
  610.  
  611. ; ******************************************************************************
  612. ; **                                                                             **
  613. ; **                                Object Types                                 **
  614. ; **                                                                             **
  615. ; ****************************************************************************
  616.  
  617. ; 
  618. ; * Note:    a call to Q3Foo_GetType will return a value kQ3FooTypeBar
  619. ; *            e.g. Q3Shared_GetType(object) returns kQ3SharedTypeShape, etc.
  620. ; 
  621.  
  622.  
  623.  
  624. kQ3ObjectTypeInvalid            EQU        0
  625. kQ3ObjectTypeView                EQU        'view'
  626. kQ3ObjectTypeElement            EQU        'elmn'
  627. kQ3ElementTypeAttribute            EQU        'eatt'
  628. kQ3ObjectTypePick                EQU        'pick'
  629. kQ3PickTypeWindowPoint            EQU        'pkwp'
  630. kQ3PickTypeWindowRect            EQU        'pkwr'
  631. kQ3ObjectTypeShared                EQU        'shrd'
  632. kQ3SharedTypeRenderer            EQU        'rddr'
  633. kQ3RendererTypeWireFrame        EQU        'wrfr'
  634. kQ3RendererTypeGeneric            EQU        'gnrr'
  635. kQ3RendererTypeInteractive        EQU        'ctwn'
  636. kQ3SharedTypeShape                EQU        'shap'
  637. kQ3ShapeTypeGeometry            EQU        'gmtr'
  638. kQ3GeometryTypeBox                EQU        'box '
  639. kQ3GeometryTypeGeneralPolygon    EQU        'gpgn'
  640. kQ3GeometryTypeLine                EQU        'line'
  641. kQ3GeometryTypeMarker            EQU        'mrkr'
  642. kQ3GeometryTypePixmapMarker        EQU        'mrkp'
  643. kQ3GeometryTypeMesh                EQU        'mesh'
  644. kQ3GeometryTypeNURBCurve        EQU        'nrbc'
  645. kQ3GeometryTypeNURBPatch        EQU        'nrbp'
  646. kQ3GeometryTypePoint            EQU        'pnt '
  647. kQ3GeometryTypePolygon            EQU        'plyg'
  648. kQ3GeometryTypePolyLine            EQU        'plyl'
  649. kQ3GeometryTypeTriangle            EQU        'trng'
  650. kQ3GeometryTypeTriGrid            EQU        'trig'
  651. kQ3GeometryTypeCone                EQU        'cone'
  652. kQ3GeometryTypeCylinder            EQU        'cyln'
  653. kQ3GeometryTypeDisk                EQU        'disk'
  654. kQ3GeometryTypeEllipse            EQU        'elps'
  655. kQ3GeometryTypeEllipsoid        EQU        'elpd'
  656. kQ3GeometryTypePolyhedron        EQU        'plhd'
  657. kQ3GeometryTypeTorus            EQU        'tors'
  658. kQ3GeometryTypeTriMesh            EQU        'tmsh'
  659. kQ3ShapeTypeShader                EQU        'shdr'
  660. kQ3ShaderTypeSurface            EQU        'sush'
  661. kQ3SurfaceShaderTypeTexture        EQU        'txsu'
  662. kQ3ShaderTypeIllumination        EQU        'ilsh'
  663. kQ3IlluminationTypePhong        EQU        'phil'
  664. kQ3IlluminationTypeLambert        EQU        'lmil'
  665. kQ3IlluminationTypeNULL            EQU        'nuil'
  666. kQ3ShapeTypeStyle                EQU        'styl'
  667. kQ3StyleTypeBackfacing            EQU        'bckf'
  668. kQ3StyleTypeInterpolation        EQU        'intp'
  669. kQ3StyleTypeFill                EQU        'fist'
  670. kQ3StyleTypePickID                EQU        'pkid'
  671. kQ3StyleTypeReceiveShadows        EQU        'rcsh'
  672. kQ3StyleTypeHighlight            EQU        'high'
  673. kQ3StyleTypeSubdivision            EQU        'sbdv'
  674. kQ3StyleTypeOrientation            EQU        'ofdr'
  675. kQ3StyleTypePickParts            EQU        'pkpt'
  676. kQ3StyleTypeAntiAlias            EQU        'anti'
  677. kQ3ShapeTypeTransform            EQU        'xfrm'
  678. kQ3TransformTypeMatrix            EQU        'mtrx'
  679. kQ3TransformTypeScale            EQU        'scal'
  680. kQ3TransformTypeTranslate        EQU        'trns'
  681. kQ3TransformTypeRotate            EQU        'rott'
  682. kQ3TransformTypeRotateAboutPoint EQU    'rtap'
  683. kQ3TransformTypeRotateAboutAxis    EQU        'rtaa'
  684. kQ3TransformTypeQuaternion        EQU        'qtrn'
  685. kQ3TransformTypeReset            EQU        'rset'
  686. kQ3ShapeTypeLight                EQU        'lght'
  687. kQ3LightTypeAmbient                EQU        'ambn'
  688. kQ3LightTypeDirectional            EQU        'drct'
  689. kQ3LightTypePoint                EQU        'pntl'
  690. kQ3LightTypeSpot                EQU        'spot'
  691. kQ3ShapeTypeCamera                EQU        'cmra'
  692. kQ3CameraTypeOrthographic        EQU        'orth'
  693. kQ3CameraTypeViewPlane            EQU        'vwpl'
  694. kQ3CameraTypeViewAngleAspect    EQU        'vana'
  695. kQ3ShapeTypeGroup                EQU        'grup'
  696. kQ3GroupTypeDisplay                EQU        'dspg'
  697. kQ3DisplayGroupTypeOrdered        EQU        'ordg'
  698. kQ3DisplayGroupTypeIOProxy        EQU        'iopx'
  699. kQ3GroupTypeLight                EQU        'lghg'
  700. kQ3GroupTypeInfo                EQU        'info'
  701. kQ3ShapeTypeUnknown                EQU        'unkn'
  702. kQ3UnknownTypeText                EQU        'uktx'
  703. kQ3UnknownTypeBinary            EQU        'ukbn'
  704. kQ3ShapeTypeReference            EQU        'rfrn'
  705. kQ3ReferenceTypeExternal        EQU        'rfex'
  706. kQ3SharedTypeSet                EQU        'set '
  707. kQ3SetTypeAttribute                EQU        'attr'
  708. kQ3SharedTypeDrawContext        EQU        'dctx'
  709. kQ3DrawContextTypePixmap        EQU        'dpxp'
  710. kQ3DrawContextTypeMacintosh        EQU        'dmac'
  711. kQ3DrawContextTypeWin32DC        EQU        'dw32'
  712. kQ3DrawContextTypeDDSurface        EQU        'ddds'
  713. kQ3DrawContextTypeX11            EQU        'dx11'
  714. kQ3SharedTypeTexture            EQU        'txtr'
  715. kQ3TextureTypePixmap            EQU        'txpm'
  716. kQ3TextureTypeMipmap            EQU        'txmm'
  717. kQ3SharedTypeFile                EQU        'file'
  718. kQ3SharedTypeStorage            EQU        'strg'
  719. kQ3StorageTypeMemory            EQU        'mems'
  720. kQ3MemoryStorageTypeHandle        EQU        'hndl'
  721. kQ3StorageTypeUnix                EQU        'uxst'
  722. kQ3UnixStorageTypePath            EQU        'unix'
  723. kQ3StorageTypeMacintosh            EQU        'macn'
  724. kQ3MacintoshStorageTypeFSSpec    EQU        'macp'
  725. kQ3StorageTypeWin32                EQU        'wist'
  726. kQ3SharedTypeString                EQU        'strn'
  727. kQ3StringTypeCString            EQU        'strc'
  728. kQ3SharedTypeShapePart            EQU        'sprt'
  729. kQ3ShapePartTypeMeshPart        EQU        'spmh'
  730. kQ3MeshPartTypeMeshFacePart        EQU        'mfac'
  731. kQ3MeshPartTypeMeshEdgePart        EQU        'medg'
  732. kQ3MeshPartTypeMeshVertexPart    EQU        'mvtx'
  733. kQ3SharedTypeControllerState    EQU        'ctst'
  734. kQ3SharedTypeTracker            EQU        'trkr'
  735. kQ3SharedTypeViewHints            EQU        'vwhn'
  736. kQ3SharedTypeEndGroup            EQU        'endg'
  737. ; ******************************************************************************
  738. ; **                                                                             **
  739. ; **                            QuickDraw 3D System Routines                     **
  740. ; **                                                                             **
  741. ; ****************************************************************************
  742.  
  743. ;
  744. ; extern TQ3Status Q3Initialize(void )
  745. ;
  746.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  747.         IMPORT_CFM_FUNCTION Q3Initialize
  748.     ENDIF
  749.  
  750. ;
  751. ; extern TQ3Status Q3Exit(void )
  752. ;
  753.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  754.         IMPORT_CFM_FUNCTION Q3Exit
  755.     ENDIF
  756.  
  757. ;
  758. ; extern TQ3Boolean Q3IsInitialized(void )
  759. ;
  760.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  761.         IMPORT_CFM_FUNCTION Q3IsInitialized
  762.     ENDIF
  763.  
  764. ;
  765. ; extern TQ3Status Q3GetVersion(unsigned long *majorRevision, unsigned long *minorRevision)
  766. ;
  767.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  768.         IMPORT_CFM_FUNCTION Q3GetVersion
  769.     ENDIF
  770.  
  771. ; 
  772. ; *  Q3GetReleaseVersion returns the release version number,
  773. ; *  in the format of the first four bytes of a 'vers' resource
  774. ; *  (e.g. 0x01518000 ==> 1.5.1 release).
  775. ; 
  776.  
  777. ;
  778. ; extern TQ3Status Q3GetReleaseVersion(unsigned long *releaseRevision)
  779. ;
  780.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  781.         IMPORT_CFM_FUNCTION Q3GetReleaseVersion
  782.     ENDIF
  783.  
  784.  
  785. ; ******************************************************************************
  786. ; **                                                                             **
  787. ; **                            ObjectClass Routines                             **
  788. ; **                                                                             **
  789. ; ****************************************************************************
  790.  
  791. ;  
  792. ; *  New object system calls to query the object system.
  793. ; *
  794. ; *  These comments to move to the stubs file before final release, they 
  795. ; *  are here for documentation for developers using early seeds.
  796. ; 
  797.  
  798. ; 
  799. ; *  Given a class name as a string return the associated class type for the 
  800. ; *  class, may return kQ3Failure if the string representing the class is 
  801. ; *  invalid.
  802. ; 
  803.  
  804. ;
  805. ; extern TQ3Status Q3ObjectHierarchy_GetTypeFromString(TQ3ObjectClassNameString objectClassString, TQ3ObjectType *objectClassType)
  806. ;
  807.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  808.         IMPORT_CFM_FUNCTION Q3ObjectHierarchy_GetTypeFromString
  809.     ENDIF
  810.  
  811. ; 
  812. ; *  Given a class type as return the associated string for the class name, 
  813. ; *  may return kQ3Failure if the type representing the class is invalid.
  814. ; 
  815.  
  816. ;
  817. ; extern TQ3Status Q3ObjectHierarchy_GetStringFromType(TQ3ObjectType objectClassType, TQ3ObjectClassNameString objectClassString)
  818. ;
  819.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  820.         IMPORT_CFM_FUNCTION Q3ObjectHierarchy_GetStringFromType
  821.     ENDIF
  822.  
  823. ;  
  824. ; *  Return true if the class with this type is registered, false if not 
  825. ; 
  826.  
  827. ;
  828. ; extern TQ3Boolean Q3ObjectHierarchy_IsTypeRegistered(TQ3ObjectType objectClassType)
  829. ;
  830.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  831.         IMPORT_CFM_FUNCTION Q3ObjectHierarchy_IsTypeRegistered
  832.     ENDIF
  833.  
  834. ;  
  835. ; *  Return true if the class with this name is registered, false if not 
  836. ; 
  837.  
  838. ;
  839. ; extern TQ3Boolean Q3ObjectHierarchy_IsNameRegistered(const char *objectClassName)
  840. ;
  841.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  842.         IMPORT_CFM_FUNCTION Q3ObjectHierarchy_IsNameRegistered
  843.     ENDIF
  844.  
  845. ; 
  846. ; * TQ3SubClassData is used when querying the object system for
  847. ; * the subclasses of a particular parent type:
  848. ; 
  849.  
  850. TQ3SubClassData            RECORD 0
  851. numClasses                 ds.l    1                ; offset: $0 (0)        ;  the # of subclass types found for a parent class 
  852. classTypes                 ds.l    1                ; offset: $4 (4)        ;  an array containing the class types 
  853. sizeof                     EQU *                    ; size:   $8 (8)
  854.                         ENDR
  855. ; 
  856. ; *  Given a parent type and an instance of the TQ3SubClassData struct fill
  857. ; *  it in with the number and class types of all of the subclasses immediately
  858. ; *  below the parent in the class hierarchy.  Return kQ3Success to indicate no
  859. ; *  errors occurred, else kQ3Failure.
  860. ; *
  861. ; *  NOTE:  This function will allocate memory for the classTypes array.  Be 
  862. ; *    sure to call Q3ObjectClass_EmptySubClassData to free this memory up.
  863. ; 
  864.  
  865. ;
  866. ; extern TQ3Status Q3ObjectHierarchy_GetSubClassData(TQ3ObjectType objectClassType, TQ3SubClassData *subClassData)
  867. ;
  868.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  869.         IMPORT_CFM_FUNCTION Q3ObjectHierarchy_GetSubClassData
  870.     ENDIF
  871.  
  872. ; 
  873. ; *  Given an instance of the TQ3SubClassData struct free all memory allocated 
  874. ; *    by the Q3ObjectClass_GetSubClassData call.
  875. ; *
  876. ; *  NOTE: This call MUST be made after a call to Q3ObjectClass_GetSubClassData
  877. ; *  to avoid memory leaks.
  878. ; 
  879.  
  880. ;
  881. ; extern TQ3Status Q3ObjectHierarchy_EmptySubClassData(TQ3SubClassData *subClassData)
  882. ;
  883.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  884.         IMPORT_CFM_FUNCTION Q3ObjectHierarchy_EmptySubClassData
  885.     ENDIF
  886.  
  887.  
  888. ; ******************************************************************************
  889. ; **                                                                             **
  890. ; **                                Object Routines                                 **
  891. ; **                                                                             **
  892. ; ****************************************************************************
  893.  
  894. ;
  895. ; extern TQ3Status Q3Object_Dispose(TQ3Object object)
  896. ;
  897.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  898.         IMPORT_CFM_FUNCTION Q3Object_Dispose
  899.     ENDIF
  900.  
  901. ;
  902. ; extern TQ3Object Q3Object_Duplicate(TQ3Object object)
  903. ;
  904.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  905.         IMPORT_CFM_FUNCTION Q3Object_Duplicate
  906.     ENDIF
  907.  
  908. ;
  909. ; extern TQ3Status Q3Object_Submit(TQ3Object object, TQ3ViewObject view)
  910. ;
  911.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  912.         IMPORT_CFM_FUNCTION Q3Object_Submit
  913.     ENDIF
  914.  
  915. ;
  916. ; extern TQ3Boolean Q3Object_IsDrawable(TQ3Object object)
  917. ;
  918.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  919.         IMPORT_CFM_FUNCTION Q3Object_IsDrawable
  920.     ENDIF
  921.  
  922. ;
  923. ; extern TQ3Boolean Q3Object_IsWritable(TQ3Object object, TQ3FileObject theFile)
  924. ;
  925.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  926.         IMPORT_CFM_FUNCTION Q3Object_IsWritable
  927.     ENDIF
  928.  
  929.  
  930. ; ******************************************************************************
  931. ; **                                                                             **
  932. ; **                            Object Type Routines                             **
  933. ; **                                                                             **
  934. ; ****************************************************************************
  935.  
  936. ;
  937. ; extern TQ3ObjectType Q3Object_GetType(TQ3Object object)
  938. ;
  939.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  940.         IMPORT_CFM_FUNCTION Q3Object_GetType
  941.     ENDIF
  942.  
  943. ;
  944. ; extern TQ3ObjectType Q3Object_GetLeafType(TQ3Object object)
  945. ;
  946.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  947.         IMPORT_CFM_FUNCTION Q3Object_GetLeafType
  948.     ENDIF
  949.  
  950. ;
  951. ; extern TQ3Boolean Q3Object_IsType(TQ3Object object, TQ3ObjectType theType)
  952. ;
  953.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  954.         IMPORT_CFM_FUNCTION Q3Object_IsType
  955.     ENDIF
  956.  
  957.  
  958. ; ******************************************************************************
  959. ; **                                                                             **
  960. ; **                            Shared Object Routines                             **
  961. ; **                                                                             **
  962. ; ****************************************************************************
  963.  
  964. ;
  965. ; extern TQ3ObjectType Q3Shared_GetType(TQ3SharedObject sharedObject)
  966. ;
  967.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  968.         IMPORT_CFM_FUNCTION Q3Shared_GetType
  969.     ENDIF
  970.  
  971. ;
  972. ; extern TQ3SharedObject Q3Shared_GetReference(TQ3SharedObject sharedObject)
  973. ;
  974.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  975.         IMPORT_CFM_FUNCTION Q3Shared_GetReference
  976.     ENDIF
  977.  
  978. ;  
  979. ; *    Q3Shared_IsReferenced
  980. ; *        Returns kQ3True if there is more than one reference to sharedObject.
  981. ; *        Returns kQ3False if there is ONE reference to sharedObject.
  982. ; *    
  983. ; *    This call is intended to allow applications and plug-in objects to delete
  984. ; *    objects of which they hold THE ONLY REFERENCE. This is useful when
  985. ; *    caching objects, etc.
  986. ; *    
  987. ; *    Although many may be tempted, DO NOT DO THIS:
  988. ; *        while (Q3Shared_IsReferenced(foo)) { Q3Object_Dispose(foo); }
  989. ; *    
  990. ; *    Your application will crash and no one will buy it. Chapter 11 is 
  991. ; *    never fun (unless you short the stock). Thanks.
  992. ; 
  993.  
  994. ;
  995. ; extern TQ3Boolean Q3Shared_IsReferenced(TQ3SharedObject sharedObject)
  996. ;
  997.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  998.         IMPORT_CFM_FUNCTION Q3Shared_IsReferenced
  999.     ENDIF
  1000.  
  1001. ; 
  1002. ; *    Q3Shared_GetEditIndex
  1003. ; *        Returns the "serial number" of sharedObject. Usefuly for caching 
  1004. ; *        object information. Returns 0 on error.
  1005. ; *        
  1006. ; *        Hold onto this number to determine if an object has changed since you
  1007. ; *        last built your caches... To validate, do:
  1008. ; *        
  1009. ; *        if (Q3Shared_GetEditIndex(foo) == oldFooEditIndex) {
  1010. ; *            // Cache is valid
  1011. ; *        } else {
  1012. ; *            // Cache is invalid
  1013. ; *            RebuildSomeSortOfCache(foo);
  1014. ; *            oldFooEditIndex = Q3Shared_GetEditIndex(foo);
  1015. ; *        }
  1016. ; 
  1017.  
  1018. ;
  1019. ; extern unsigned long Q3Shared_GetEditIndex(TQ3SharedObject sharedObject)
  1020. ;
  1021.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1022.         IMPORT_CFM_FUNCTION Q3Shared_GetEditIndex
  1023.     ENDIF
  1024.  
  1025. ; 
  1026. ; *    Q3Shared_Edited
  1027. ; *        Bumps the "serial number" of sharedObject to a different value. This
  1028. ; *        call is intended to be used solely from a plug-in object which is 
  1029. ; *        shared. Call this whenever your private instance data changes.
  1030. ; *        
  1031. ; *        Returns kQ3Failure iff sharedObject is not a shared object, OR
  1032. ; *            QuickDraw 3D isn't initialized.
  1033. ; 
  1034.  
  1035. ;
  1036. ; extern TQ3Status Q3Shared_Edited(TQ3SharedObject sharedObject)
  1037. ;
  1038.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1039.         IMPORT_CFM_FUNCTION Q3Shared_Edited
  1040.     ENDIF
  1041.  
  1042.  
  1043. ; ******************************************************************************
  1044. ; **                                                                             **
  1045. ; **                                Shape Routines                                 **
  1046. ; **                                                                             **
  1047. ; ****************************************************************************
  1048.  
  1049. ; 
  1050. ; *    QuickDraw 3D 1.5 Note:
  1051. ; *
  1052. ; *    Shapes and Sets are now (sort of) polymorphic.
  1053. ; *
  1054. ; *        You may call Q3Shape_Foo or Q3Set_Foo on a shape or a set.
  1055. ; *        The following calls are identical, in implementation:
  1056. ; *
  1057. ; *            Q3Shape_GetElement            =    Q3Set_Get
  1058. ; *            Q3Shape_AddElement            =    Q3Set_Add
  1059. ; *            Q3Shape_ContainsElement        =    Q3Set_Contains
  1060. ; *            Q3Shape_GetNextElementType    =    Q3Set_GetNextElementType
  1061. ; *            Q3Shape_EmptyElements        =    Q3Set_Empty
  1062. ; *            Q3Shape_ClearElement        =    Q3Set_Clear
  1063. ; *
  1064. ; *    All of these calls accept a shape or a set as their first parameter.
  1065. ; *
  1066. ; *    The Q3Shape_GetSet and Q3ShapeSetSet calls are implemented via a new
  1067. ; *    element type kQ3ElementTypeSet. See the note above about 
  1068. ; *    kQ3ElementTypeSet;
  1069. ; *
  1070. ; *    It is important to note that the new Q3Shape_...Element... calls do not
  1071. ; *    create a set on a shape and then add the element to it. This data is
  1072. ; *    attached directly to the shape. Therefore, it is possible for an element
  1073. ; *    to exist on a shape without a set existing on it as well. 
  1074. ; *
  1075. ; *    In your application, if you attach an element to a shape like this:
  1076. ; *        (this isn't checking for errors for simplicity)
  1077. ; *
  1078. ; *        set = Q3Set_New();
  1079. ; *        Q3Set_AddElement(set, kMyElemType, &data);
  1080. ; *        Q3Shape_SetSet(shape, set);
  1081. ; *
  1082. ; *    You should retrieve it in the same manner:
  1083. ; *
  1084. ; *        Q3Shape_GetSet(shape, &set);
  1085. ; *        if (Q3Set_Contains(set, kMyElemType) == kTrue) {
  1086. ; *            Q3Set_Get(set, kMyElemType, &data);
  1087. ; *        }
  1088. ; *
  1089. ; *    Similarly, if you attach data to a shape with the new calls:
  1090. ; *
  1091. ; *        Q3Shape_AddElement(shape, kMyElemType, &data);
  1092. ; *
  1093. ; *    You should retrieve it in the same manner:
  1094. ; *
  1095. ; *        if (Q3Shape_ContainsElement(set, kMyElemType) == kTrue) {
  1096. ; *            Q3Shape_GetElement(set, kMyElemType, &data);
  1097. ; *        }
  1098. ; *
  1099. ; *    This really becomes an issue when dealing with version 1.0 and version 1.1 
  1100. ; *    metafiles.
  1101. ; *
  1102. ; *    When attempting to find a particular element on a shape, you should
  1103. ; *    first check with Q3Shape_GetNextElementType or Q3Shape_GetElement, then,
  1104. ; *    Q3Shape_GetSet(s, &set) (or Q3Shape_GetElement(s, kQ3ElementTypeSet, &set))
  1105. ; *    and then Q3Shape_GetElement(set, ...).
  1106. ; *
  1107. ; *    In terms of implementation, Q3Shape_SetSet and Q3Shape_GetSet should only be
  1108. ; *    used for sets of information that are shared among multiple shapes.
  1109. ; *    
  1110. ; *    Q3Shape_AddElement, Q3Shape_GetElement, etc. calls should only be used
  1111. ; *    for elements that are unique for a particular shape.
  1112. ; *    
  1113. ; 
  1114.  
  1115. ;
  1116. ; extern TQ3ObjectType Q3Shape_GetType(TQ3ShapeObject shape)
  1117. ;
  1118.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1119.         IMPORT_CFM_FUNCTION Q3Shape_GetType
  1120.     ENDIF
  1121.  
  1122. ;
  1123. ; extern TQ3Status Q3Shape_GetSet(TQ3ShapeObject shape, TQ3SetObject *theSet)
  1124. ;
  1125.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1126.         IMPORT_CFM_FUNCTION Q3Shape_GetSet
  1127.     ENDIF
  1128.  
  1129. ;
  1130. ; extern TQ3Status Q3Shape_SetSet(TQ3ShapeObject shape, TQ3SetObject theSet)
  1131. ;
  1132.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1133.         IMPORT_CFM_FUNCTION Q3Shape_SetSet
  1134.     ENDIF
  1135.  
  1136. ;
  1137. ; extern TQ3Status Q3Shape_AddElement(TQ3ShapeObject shape, TQ3ElementType theType, const void *data)
  1138. ;
  1139.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1140.         IMPORT_CFM_FUNCTION Q3Shape_AddElement
  1141.     ENDIF
  1142.  
  1143. ;
  1144. ; extern TQ3Status Q3Shape_GetElement(TQ3ShapeObject shape, TQ3ElementType theType, void *data)
  1145. ;
  1146.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1147.         IMPORT_CFM_FUNCTION Q3Shape_GetElement
  1148.     ENDIF
  1149.  
  1150. ;
  1151. ; extern TQ3Boolean Q3Shape_ContainsElement(TQ3ShapeObject shape, TQ3ElementType theType)
  1152. ;
  1153.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1154.         IMPORT_CFM_FUNCTION Q3Shape_ContainsElement
  1155.     ENDIF
  1156.  
  1157. ;
  1158. ; extern TQ3Status Q3Shape_GetNextElementType(TQ3ShapeObject shape, TQ3ElementType *theType)
  1159. ;
  1160.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1161.         IMPORT_CFM_FUNCTION Q3Shape_GetNextElementType
  1162.     ENDIF
  1163.  
  1164. ;
  1165. ; extern TQ3Status Q3Shape_EmptyElements(TQ3ShapeObject shape)
  1166. ;
  1167.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1168.         IMPORT_CFM_FUNCTION Q3Shape_EmptyElements
  1169.     ENDIF
  1170.  
  1171. ;
  1172. ; extern TQ3Status Q3Shape_ClearElement(TQ3ShapeObject shape, TQ3ElementType theType)
  1173. ;
  1174.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1175.         IMPORT_CFM_FUNCTION Q3Shape_ClearElement
  1176.     ENDIF
  1177.  
  1178.  
  1179. ; ******************************************************************************
  1180. ; **                                                                             **
  1181. ; **                            Color Table Routines                             **
  1182. ; **                                                                             **
  1183. ; ****************************************************************************
  1184.  
  1185. ;
  1186. ; extern TQ3Status Q3Bitmap_Empty(TQ3Bitmap *bitmap)
  1187. ;
  1188.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1189.         IMPORT_CFM_FUNCTION Q3Bitmap_Empty
  1190.     ENDIF
  1191.  
  1192. ;
  1193. ; extern unsigned long Q3Bitmap_GetImageSize(unsigned long width, unsigned long height)
  1194. ;
  1195.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1196.         IMPORT_CFM_FUNCTION Q3Bitmap_GetImageSize
  1197.     ENDIF
  1198.  
  1199.  
  1200.  
  1201.     ENDIF ; __QD3D__ 
  1202.  
  1203.